home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / systune.z / systune
Encoding:
Text File  |  2002-10-03  |  11.0 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ssssyyyyssssttttuuuunnnneeee((((1111MMMM))))                                                        ssssyyyyssssttttuuuunnnneeee((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      systune - display and set tunable parameters
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssyyyyssssttttuuuunnnneeee [ ----bbbbffffiiiirrrr ] [ ----nnnn name ] [ ----pppp rootpath ]
  13.            [ variable [ value ] ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _s_y_s_t_u_n_e is a tool that enables you to examine and configure your tunable
  17.      kernel parameters.  _s_y_s_t_u_n_e can adjust some parameters in real time and
  18.      informs you if you need to reboot your system after reconfiguration.  It
  19.      saves the reconfigured kernel in /_u_n_i_x._i_n_s_t_a_l_l, unless the ----ffff option is
  20.      used.
  21.  
  22.      _s_y_s_t_u_n_e has two modes: interactive and noninteractive.  Interactive mode
  23.      allows you to query information about various portions of tunable
  24.      parameters or to set new values for tunable parameters.  Some parameters
  25.      can be changed while the system is running, and some require a new copy
  26.      of the kernel to be booted.  To enter interactive mode, use the ----iiii
  27.      option.  In noninteractive mode, _s_y_s_t_u_n_e displays the values of one
  28.      tunable parameter or group of tunable parameters, or allows the value of
  29.      one tunable parameter to be changed.  Note that you will still be
  30.      prompted for a confirmation when changing a parameter in noninteractive
  31.      mode.  To avoid interacting with the confirmation you must use additional
  32.      commands, for example:
  33.  
  34.          # eeeecccchhhhoooo yyyy |||| ssssyyyyssssttttuuuunnnneeee nnnnpppprrrroooocccc 444400000000
  35.  
  36.      Noninteractive mode is the default.
  37.  
  38.      The options are:
  39.  
  40.      ----bbbb      Both target kernel and the running system are updated with the
  41.              new values that you specified, if the new values are within the
  42.              legal range for the parameter specified in /_v_a_r/_s_y_s_g_e_n/_m_t_u_n_e.
  43.              The new values with the corresponding tunable variables are also
  44.              added into /_v_a_r/_s_y_s_g_e_n/_s_t_u_n_e file.  This is the default behavior.
  45.  
  46.      ----ffff      This option forces _s_y_s_t_u_n_e to not save the reconfigured kernel in
  47.              /_u_n_i_x._i_n_s_t_a_l_l.  By default, _s_y_s_t_u_n_e tests to see if /_u_n_i_x._i_n_s_t_a_l_l
  48.              exists and whether it is identical to the running system.  If it
  49.              is identical, _s_y_s_t_u_n_e makes any changes in /_u_n_i_x._i_n_s_t_a_l_l;
  50.              otherwise, _s_y_s_t_u_n_e copies the current /_u_n_i_x kernel or the kernel
  51.              specified by the ----nnnn option to /_u_n_i_x._i_n_s_t_a_l_l and makes all changes
  52.              to the copied kernel.  If the copy fails for any reason, such as
  53.              lack of disk space or the presence of the ----ffff option, the
  54.              currently running kernel is changed.
  55.  
  56.      ----iiii      Run _s_y_s_t_u_n_e in interactive mode.  When _s_y_s_t_u_n_e is invoked in
  57.              interactive mode, no parameter values are immediately displayed.
  58.              Instead, you see the _s_y_s_t_u_n_e prompt:
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssyyyyssssttttuuuunnnneeee((((1111MMMM))))                                                        ssssyyyyssssttttuuuunnnneeee((((1111MMMM))))
  71.  
  72.  
  73.  
  74.                  systune->
  75.  
  76.              The commands available in interactive mode are described below.
  77.  
  78.      ----nnnn _n_a_m_e This option specifies an alternate kernel _n_a_m_e to tune in place
  79.              of ////uuuunnnniiiixxxx.
  80.  
  81.      ----pppp _r_o_o_t_p_a_t_h
  82.              If you specify this option, _r_o_o_t_p_a_t_h becomes the starting
  83.              pathname for _s_y_s_t_u_n_e to check for /_v_a_r/_s_y_s_g_e_n/_s_t_u_n_e and
  84.              /_v_a_r/_s_y_s_g_e_n/_m_t_u_n_e.  The default _r_o_o_t_p_a_t_h directory is ////.
  85.  
  86.      ----rrrr      The new values change on the running system only.  If the tunable
  87.              parameter can not be changed on the running system, nothing is
  88.              affected.  The default is ----bbbb.
  89.  
  90.      If the name of a variable is specified on the command line, its current
  91.      value is displayed.  If the name of a group is specified on the command
  92.      line, the names and values of all variables in that group are displayed.
  93.      If the name of a variable and a value are specified on the command line,
  94.      the variable's value is changed after verification and confirmation.
  95.  
  96.      The _s_y_s_t_u_n_e commands available in interactive mode are:
  97.  
  98.      qqqquuuuiiiitttt    Quit _s_y_s_t_u_n_e immediately.  Any changes you have made up to that
  99.              point are saved and cannot be discarded.  You must go through and
  100.              change back any parameters that you do not wish to be changed.
  101.  
  102.      aaaallllllll     Print information on all tunable parameters.  This command
  103.              displays the same information as _s_y_s_t_u_n_e invoked in
  104.              noninteractive mode.
  105.  
  106.      hhhheeeellllpppp    Show all the built-in commands and group names.  _s_y_s_t_u_n_e lists
  107.              two commands (hhhheeeellllpppp and aaaallllllll) and the groups of kernel tunable
  108.              parameters.  Each group of tunable parameters is organized so
  109.              that related parameters are kept together.  For example, the
  110.              nnnnuuuummmmpppprrrroooocccc parameter group contains parameters related to the number
  111.              of processes allowed to run on the system at any given time.  Its
  112.              parameters are:
  113.  
  114.                   ncsize = 808 (0x328)
  115.                   ncallout = 40 (0x28)
  116.                   callout_himark = 332 (0x14c)
  117.                   ndquot = 808 (0x328)
  118.                   nproc = 300 (0x12c)
  119.  
  120.      _p_a_r_a_m_e_t_e_r__g_r_o_u_p_n_a_m_e
  121.              Display information for all the tunable parameters in this group
  122.              along with their values in decimal numerals and in hexadecimal
  123.              notation.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssyyyyssssttttuuuunnnneeee((((1111MMMM))))                                                        ssssyyyyssssttttuuuunnnneeee((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      _p_a_r_a_m_e_t_e_r__n_a_m_e
  141.              Display information for this tunable parameter only.
  142.  
  143.      _p_a_r_a_m_e_t_e_r__n_a_m_e _n_e_w_v_a_l_u_e
  144.              Set the specified tunable parameter to the new value.  For
  145.              example, to raise the nnnnpppprrrroooocccc parameter in the nnnnuuuummmmpppprrrroooocccc parameter
  146.              group from 300 to 400, follow this example:
  147.  
  148.                   systune-> _nnnn_pppp_rrrr_oooo_cccc _4444_0000_0000
  149.                   nproc = 300 (0x12c)
  150.  
  151.                   Do you really want to change nproc to 400 (0x190)? (y/n) _yyyy
  152.  
  153.                   In order for the change in parameter nproc to become
  154.                   effective, /unix.install must be moved to /unix and the
  155.                   system rebooted.
  156.  
  157.              This message tells you that the change does not take effect until
  158.              a new kernel with the new value is running on your system.
  159.              _s_y_s_t_u_n_e always prints a message to inform you if you need to
  160.              reboot your system for a kernel change to take effect.
  161.  
  162.              _s_y_s_t_u_n_e makes all requested changes to the kernel in three
  163.              places, if possible.  (Nondynamically adjustable parameters can
  164.              be changed in only two out of three places.) The parameters are
  165.              changed in:
  166.  
  167.              +o  the running kernel image on the workstation
  168.              +o  the /_u_n_i_x or /_u_n_i_x._i_n_s_t_a_l_l file
  169.              +o  the /_v_a_r/_s_y_s_g_e_n/_s_t_u_n_e file
  170.  
  171.              Some sanity checking is performed on the modified kernel
  172.              parameters to help prevent the creation of kernels that will not
  173.              function correctly.  This checking is performed both by _s_y_s_t_u_n_e
  174.              and by the _l_b_o_o_t(1M) command.  For example, some variables have
  175.              preset minimum and maximum values.  Any attempt to change the
  176.              variable beyond these threshold values results in an error
  177.              message, and the variable is not changed.
  178.  
  179. BBBBUUUUGGGGSSSS
  180.      When the system calculates its default value for a systune, the resulting
  181.      value may be outside the valid range provided by the mtune file.  For
  182.      example, if you set mbmaxpages to 0 (i.e. ask system for default value)
  183.      then on a 32-bit system with 256M of RAM the default is set to 16384.
  184.      However the maximum allowed by mtune is 8192.  In this example, the
  185.      system will configure mbmaxpages to 16384 from the default of 0, but it
  186.      is not possible to assign mbmaxpages > 8192 directly from systune because
  187.      of the restriction in mtune.
  188.  
  189.      Also, systune may not show the user-defined value of syssegsz after
  190.      reboot. This is due to the fact that the colormap must be calculated and
  191.      added to syssegsz for machine types IP19, IP20, IP22, and IP32.  When
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ssssyyyyssssttttuuuunnnneeee((((1111MMMM))))                                                        ssssyyyyssssttttuuuunnnneeee((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      systune is called it compares the value of syssegsz in the kernel to the
  207.      value set in /var/sysgen/stune.  If this is done on one of the above
  208.      machines, they will not match because syssegsz has been altered with the
  209.      colormap value in the kernel, but not in the stune file.  This is a
  210.      normal function and should not be a concern.
  211.  
  212.  
  213. FFFFIIIILLLLEEEESSSS
  214.      /var/sysgen/mtune/*   system tunable parameters
  215.      /var/sysgen/stune     local settings for system tunable parameters
  216.  
  217. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  218.      autoconfig(1M), lboot(1M), mtune(4), stune(4).
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.